home *** CD-ROM | disk | FTP | other *** search
/ Symantec Visual Cafe for Java 2.5 / symantec-visual-cafe-2.5-database-dev-edition.iso / Visual Cafe Pro v1.0 / _SETUP.LIB / README.TXT < prev    next >
Encoding:
Text File  |  1997-04-11  |  23.1 KB  |  534 lines
  1. README for Symantec Visual Cafe PRO Version 1.0
  2. ================================================================
  3. Copyright (c) 1996 by Symantec Corporation. All Rights Reserved.
  4.  
  5. NOTE:  
  6. The Visual Cafe PRO consists of two products: the Visual Integrated 
  7. Development Environment (e.g. Visual Cafe) with database aware 
  8. functionality (components, wizards, interactions), and the 
  9. dbANYWHERE workgroup server.  This README file is explicitly for 
  10. Visual Cafe PRO, and a separate one exists for dbANYWHERE.
  11.  
  12. Table of Contents:
  13. I.    Welcome
  14. II.   Installation Notes
  15. III.  User Tips
  16. IV.   Known Problems-PRO Specific and Vendor Specific
  17. V.    Contacting Symantec for Technical Support
  18. VI.   Additional Information
  19.  
  20.  
  21. I.  Welcome!
  22.  
  23. Welcome to Symantec Visual Cafe PRO Version 1.0 for Windows 95
  24. and Windows NT.  Please take a few minutes to read this file.
  25.  
  26.  
  27. II.  Installation Notes
  28. ================================================================
  29. If you have previously downloaded the Preview Releases of Visual Cafe, 
  30. you must remove them before installing Visual Cafe PRO 1.0.
  31.  
  32. Run setup.exe. The installation is smooth and intuitive. As with
  33. any new software, please install Visual Cafe PRO in a clean directory.   
  34.  
  35. Installing Visual Cafe PRO with an Existing Version of Visual Cafe is
  36. possible.  Just ensure that you do not install to the same directory.
  37.  
  38. Installing and Running the Tutorial
  39. ---------------------------------------------------------------
  40. If you are new to Java development, please take the time to work
  41. through the exciting and informative tutorial that is part of 
  42. Visual Cafe PRO.  This tutorial will provide you with an overview 
  43. of Visual Cafe PRO's most powerful features. 
  44.  
  45. What's in the Tutorial?
  46. ---------------------------------------------------------------
  47. In the Tutorial you will learn how to:
  48.  
  49. * Design an applet, then build, and install it in a Web page.
  50. * Run the applet in a Web browser.
  51. * Design an application, then build, test, debug, and run it.
  52.  
  53.  
  54. III.  User Tips
  55. ================================================================
  56. How do I configure my Web browser to run an applet I created 
  57. using custom classes?
  58.  
  59. When you are ready to view your applet outside of the Visual Cafe PRO 
  60. environment, you need to make sure that the AppletViewer or your 
  61. favorite WWW browser can find the custom classes included with 
  62. Visual Cafe PRO.  For local browsing, add the CLASSPATH environment 
  63. variable to your autoexec.bat or system or config.sys file, such as:
  64.  
  65.     CLASSPATH=C:\visualcafepro\java\lib\symclass.zip;  
  66.  
  67.             *
  68.  
  69. How do I distribute my applet on a Web server?
  70.  
  71. When placing the applet on a WWW server, contact your Webmaster and 
  72. verify that the Symantec classes are available.  If the classes are 
  73. not available on your server, the Webmaster will need to add them or
  74. tell you how to add them.  If you are the Webmaster, the classes in 
  75. the symclass.zip file need to be in the server's classpath.
  76.  
  77. A solution that works locally, or from a server, is to copy the 
  78. \VisualCafe\Java\Lib\symantec directory and all of its contents to 
  79. the directory containing the applet. (The subdirectories of the
  80. "symantec" directory contain the Visual Cafe PRO Java runtime classes.)
  81.  
  82. Symantec has tested the deployment of Visual Cafe PRO generated Java
  83. applets in various browsers.  There are several configuration issues 
  84. concerning which Internet Browser you utilize for running Java applets.
  85. This involves the downloading of Java class files, packages, and TCP/IP
  86. connectivity.  Please consult the User Guide regarding browsers before 
  87. deploying your Java applets.
  88.  
  89. Remember to compile your applet before deploying on a web site.  Simply
  90. saving your applet after making changes will not cause those changes to
  91. take affect in the applet.
  92.  
  93.                 *
  94.  
  95. What is the "Execute applet in default HTML viewer" option in the 
  96. Project Options dialog?
  97.  
  98. The "Execute applet in default HTML viewer" option, located in 
  99. the Project Options dialog box, allows you to view your applet 
  100. in your favorite WWW browser, instead of the AppletViewer, 
  101. when executing from the Visual Cafe PRO environment.
  102.  
  103.             *
  104.  
  105. Will Visual Cafe PRO recognize my own source code?
  106.  
  107. When adding controls directly within the source editor, it 
  108. is recommended that you adhere to the same coding style as 
  109. generated by Visual Cafe PRO.
  110.  
  111. For example, if you are adding controls within Visual Cafe PRO's tags 
  112. in the source editor, you should adhere to Visual Cafe PRO's coding 
  113. style.  Otherwise, you can add controls outside Visual Cafe PRO's tags 
  114. using your own coding style.
  115.  
  116.             *
  117.  
  118. What do I need to do to enable Remote Debugging?
  119.  
  120. If you are using cafeRemote on a remote computer for remote debugging 
  121. you must modify the autoexec.bat file on that machine. You must 
  122. also include VisualCafe\java\bin your PATH, and create and set a 
  123. CLASSPATH system variable to include all necessary classes for 
  124. the Applet or Application you are debugging. Here is an example:
  125.  
  126. set PATH=C:\VisualCafe\Java\Bin;%PATH% 
  127. set CLASSPATH=C:\VisualCafe\Java\Lib;C:\VisualCafe\Java\Lib\SYMCLASS.ZIP;
  128. C:\VisualCafe\Java\Lib\VECCLASS.ZIP;C:\VisualCafe\Java\Lib\SYMANTEC.ZIP;
  129. C:\VisualCafe\Java\Lib\SYMANTEC.ZIP;C:\YOUR_CLASSES
  130.  
  131. Note that a PATH or CLASSPATH statement in your system files 
  132. is one continuous line with no spaces or carriage returns.
  133.  
  134.             *
  135.  
  136. When running an applet in a browser, resizing the browser causes my
  137. database connection to be lost.  What went wrong?
  138.  
  139. One major issue facing Java applets running in typical Internet 
  140. Browsers is browser resizing.  Default logic seems to be the destroying
  141. and restarting of a Java applet upon ANY change to the size of the 
  142. browser window.  If a session.Close() is called when destroying the 
  143. applet, the data connection is lost and must be re-established when the 
  144. applet is restarted.  The solution provided by default in Visual Cafe 
  145. PRO is to maintain a persistent database connection.  This means that 
  146. any browser resizing will not lose the connection--a desirable trait.  
  147. However, the drawback is that the connection will be maintained until 
  148. the browser is closed.  To accomodate this, you may want to provide a 
  149. Close button on the applet that calls session.close().
  150.  
  151.  
  152. IV.  Known Problems-PRO Specific and Vendor Specific
  153. ================================================================
  154. This section lists information on known problems with Visual Cafe PRO, 
  155. and alternative actions that can be taken to avoid them.
  156.  
  157. * If you encounter an error upon starting Visual Cafe PRO, try 
  158.   deleting the following files from \visualcafepro\bin:
  159.     *.rps
  160.     *.reg
  161.     *.vws
  162.  
  163.   Note: Some of the errors are:
  164.     "No starter templates could be found"
  165.     "Cannot open local repository"
  166.     "Cannot open registry"
  167.  
  168.   These files are platform-dependent and must be regenerated
  169.   when switching from one OS to another.  
  170.  
  171. * Due to architectual changes within Visual Cafe PRO projects, we are 
  172.   not compatible with Visual Cafe Preview 1 or 2 .VPJ files.  Also, it
  173.   is not suggested that you mix projects between Visual Cafe and Visual
  174.   Cafe PRO.
  175.  
  176. * When using the Parse All Imports option, we recommend that you
  177.   allow the parser to finish parsing before editing or changing 
  178.   a file.  To view the status of the parser, select Messages 
  179.   from the Visual Cafe PRO Window menu.
  180.  
  181. * The x and y dimension properties in the Property Inspector are 
  182.   not applicable for root level objects.  No effect is achieved 
  183.   if you change these settings.
  184.  
  185. * When building applets/applications for Microsoft Internet Explorer 
  186.   you should not use the project option for Java Optimization or the 
  187.   -O switch.
  188.  
  189. * It is not possible to resize some of the dbAWARE objects, such as
  190.   the Session, ConnectionInfo, and RelationView.  Since these are not
  191.   visible at runtime, there is no need to alter their appearance.  It
  192.   is also recommended that you do not Cut and Paste these objects.
  193.  
  194. * When employing graphic images (binaries) in applets, sizes beyond 50k
  195.   will show increasingly slow performance for this release.  You are
  196.   encouraged to try keeping them as small as possible for better 
  197.   performance.
  198.  
  199. * Back Parsing
  200.   1. Visual Cafe PRO provides sophisticated editing abilities, where a 
  201.   change to an object in the Property List window will automatically 
  202.   generate the code change in the source, or an object added to the 
  203.   source will appear on the form and in the Project window.  However, 
  204.   there have been some problems noted with this facility, where 
  205.   extensive changes to object names in the source will ocassionally 
  206.   cause invalid back parsing.  It is suggested that changes be made 
  207.   through the Property List window as often as possible.
  208.  
  209.   2. RadioButton and RadioBox objects do not successfully back parse.
  210.  
  211. * Components
  212.   1. The Grid control is a very recent addition, and has not been 
  213.   tested to a high degree.  There are painting and refreshing issues 
  214.   that will be addressed in the next release.
  215.  
  216.   2. The KeyPressManagerPanel is inserted into dbAWARE Projects by 
  217.   default, because it facilitates tabbing between controls (something 
  218.   quite lacking from most Java applets today).  However, there are some 
  219.   quirky behaviors to it that should be taken into account.  If you 
  220.   attempt to add additional data aware controls by dragging columns 
  221.   from the dbNAVIGATOR onto your applet, nothing happens.  If you drag
  222.   the columns to the Project window and drop them on the KeyPressManager
  223.   Panel object, they will all size to the dimensions of the Panel 
  224.   object.  You will be forced to manually change the size of each 
  225.   control through the Property List window.  For simplicity, make sure
  226.   you include all of the desired columns, then optionally remove them 
  227.   later.
  228.  
  229. * There are several layout options available for applets, which consist 
  230.   of BorderLayout, CardLayout, FlowLayout, GridBagLayout, and 
  231.   GridLayout.  A bug exists where the selection of CardLayout will 
  232.   cause ALL of the objects in your applet to resize to the dimensions 
  233.   of the applet window.  This option is selected by default, and will 
  234.   not cause a problem, unless you choose a different layout and then 
  235.   return to CardLayout.  The only recourse after doing this is to 
  236.   manually alter the X,Y,Width, and Height parameters in the Property 
  237.   List for each object.
  238.  
  239. * The HELP file mistakenly references TWO separate drivers for Oracle.
  240.   In earlier versions of dbANYWHERE, there was a separate driver for 
  241.   Windows NT and Windows 95.  For this release, the drivers have 
  242.   combined into one.  Make sure you reference the driver as "ORACLE_7".
  243.  
  244.  
  245.   Vendor Specific Problems:
  246.   -------------------------
  247.  
  248. * Microsoft Access
  249.  
  250.   There are some problems with using dbANYWHERE connections to 
  251.   Microsoft Access Jet Engine databases earlier than the 7.0 version 
  252.   on Windows NT 4.0, due to some Access problems.  It is recommended 
  253.   that you download the free update available on the Microsoft web 
  254.   site.  The file to get is msjt3032.dll which contains the following 
  255.   files: msjt3032.dll, mswng300.dll, msajetfs.dll, readme.txt, and 
  256.   62317T.doc.  For additional information about this update, see the 
  257.   following article in the Microsoft Knowledge Base:  Article-ID: 
  258.   Q143163; TITLE: Problems Running Microsoft Jet 3.0 on Windows NT 4.
  259.  
  260. * Microsoft Internet Explorer
  261.  
  262.   Microsoft's Internet Explorer was tested with running Java applets, 
  263.   but one of the more notable problems encountered concerned the use 
  264.   of the host name "localhost."  This is a default TCP/IP entry 
  265.   (127.0.0.1) in your HOSTS or LMHOSTS file which allows you to 
  266.   reference the local machine running dbANYWHERE, instead of 
  267.   specifying an IP address.  In some cases, Internet Explorer failed 
  268.   to resolve the "localhost" reference, requiring the use of the full 
  269.   IP addresss.  You may find it best to use IP Addresses or registered
  270.   Domain Names whenever possible.
  271.  
  272. * Sybase SQL Anywhere 5.5
  273.  
  274.   There tends to be a large memory and/or resource leak with repeated
  275.   connects and disconnects to SQL Anywhere 5.5 via ODBC.  Each 
  276.   connect/disconnect consumes 50-100Kbytes of virtual memory that is 
  277.   not given back to the system until the client application terminates.  This is
  278.   under both Win95 and WinNT (3.51 & 4.0).  Technical Support at Sybase
  279.   confirmed this on high numbers of connect/disconnect sequences in 
  280.   5.5.0.  They also claim that it should be fixed in 5.5.01.  There is
  281.   an EBF file on their FTP/WEB Server that may or may not contain the 
  282.   fix.
  283.  
  284.   Note: In the documentation, the names Watcom and SQL Anywhere are 
  285.   used interchangeably, since Watcom is the original name of this 
  286.   database engine (prior to the Sybase acquisition).
  287.  
  288.  
  289. JDK Version Incompatibilities
  290. -----------------------------------------------------------------
  291. Symantec Visual Cafe PRO 1.0 supports version 1.0.2 of the Java 
  292. Development Kit from Sun Microsystems.  Also, the JDBC API included
  293. supports version 1.1 of the JDBC specification.
  294.  
  295. Some behaviors of the java.awt components are not correct on the
  296. Microsoft Windows platforms.  
  297.  
  298. These platform-dependent problems include:
  299.  
  300. * Buttons and labels do not support foreground or background colors.
  301. * Checkbox/radiobuttons don't support foreground color.
  302. * Lists size themselves to specific increments (to completely hold 
  303.    lines of text). 
  304. * Dialog boxes do not initially return appropriate values from insets, 
  305.    placing the first component incorrectly in the Form Designer.
  306. * Help menus do not appear on the right side of the menu bar.
  307. * Choice and List components incorrectly display their size and 
  308.    position if not used in conjunction with a layout manager.
  309.  
  310.    Visual Cafe PRO issues a reshape after the component is added 
  311.    which addresses this problem. However, if you try to use 
  312.    decendents of these classes you will need to add a call to reshape
  313.    after the component has been added.  For example,
  314.  
  315.     //{{INIT_CONTROLS
  316.     choice1 = new java.awt.Choice();
  317.     choice1.reshape(119,72,135,21);
  318.     add(choice1);
  319.     //}}
  320.  
  321.     // Create the reshape call after the auto generated code              
  322.     choice1.reshape(119,72,135,21);
  323.  
  324.  
  325. These problems should be resolved with the 1.1 release of the JDK.
  326.  
  327.  
  328. JDBC Specification Problems
  329. -----------------------------------------------------------------
  330.  
  331. * Stored Procedures
  332.   The JDBC specification states the following format to be used 
  333.   for stored  procedures:
  334.  
  335.   { call procedure_name [?,?,....] }
  336.  
  337.   where procedure_name - is the name of the procedure
  338.         ?,?.....       - are the placeholders to be used for parameters
  339.   In the real world, the above doesn't work for all different drivers. 
  340.   So, remember these guidelines:
  341.  
  342.   a. Sybase SQL AnyWhere / Watcom
  343.  
  344.   ODBC drivers are supposed to support the above escape processing 
  345.   syntax for stored procedures.  Unfortunately the Watcom ODBC driver
  346.   doesn't support this. So, always use native calling syntax with 
  347.   Watcom, which is, "call procedure_name ( ?, ?, ? )".
  348.  
  349.   But if you were really brave and wanted to try using the ODBC 
  350.   standard, you would get an "Unable to prepare SQL Statement" 
  351.   exception or some other related message.
  352.  
  353.   b. All InterSolv ODBC Drivers
  354.  
  355.   These drivers do behave a little bit better than the Watcom driver. 
  356.   They let you to prepare the statement, but while executing the 
  357.   statement by executeUpdate(), execute() etc, sometimes strange 
  358.   errors are displayed.  It may be prudent to utilize the dbANYWHERE 
  359.   direct drivers whenever possible.
  360.  
  361.   c. Native Sybase driver, Microsoft SQL Server driver.
  362.  
  363.     Should work fine without a problem.
  364.  
  365.   d. Native Oracle driver.
  366.  
  367.   Works fine but make sure to include an extra set of () around the 
  368.   placeholders.  This requirement may be alleviated in future versions.
  369.  
  370.   { call procedure_name [(?,?,....)] } 
  371.   Note the () around placeholders
  372.  
  373.  
  374. * Date datatypes are restricted to the range 1970-01-01 to 1999-12-31.
  375.    Attempts to retrieve data with dates outside this range will throw
  376.    an exception that can, in some cases, be unrecoverable.
  377.  
  378. * Excessively large datatypes that go beyond the definitions that 
  379.    JDBC can handle, will cause applets to hang when running.  For 
  380.    example, if you are using Oracle and project a column of datatype 
  381.    NUMBER(38), the applet will hang when executing (no controls will 
  382.    appear).  Make sure you do not violate the datatype limits of JDBC.
  383.  
  384.  
  385. Low-memory warning on startup
  386. -----------------------------------------------------------------
  387. If the sum of your system's available physical memory (RAM) and
  388. swap space on disk is below a minimal level when Visual 
  389. Cafe PRO starts up, a warning dialog will notify you of this condition.
  390. We will  advise you to increase swap space (see
  391. below).  You have the option of ignoring this warning (answer 
  392. "No" to the "Quit?" prompt), and proceeding to run Visual Cafe PRO. 
  393. With light use, you may not experience any problems at all. But
  394. with typical use, at some time in the course of your Visual Cafe PRO 
  395. session you may begin to see "low virtual memory" warnings from 
  396. the operating system.  Typical symptoms of running any complex 
  397. application with too little available memory are sluggish 
  398. performance and unstable system behavior.
  399.  
  400. If the warning dialog recommends that you increase swap space by 
  401. some small amount, such as 2 or 3 MB, please increase minimum 
  402. swap space on Windows NT, or free disk space on Windows 95, by 
  403. at least 5 MB.
  404.  
  405. On Windows 95, if the option is selected in 
  406. Settings | Control Panel | System | Performance | Virtual Memory
  407. to let the OS manage swap space (this is the default), then 
  408. available swap space is simply the amount of free disk space; 
  409. but note that there is no guaranteed minimum:  
  410. the disk, there is no swap space available.
  411.  
  412. On Windows NT 3.51, Control Panel is started from Program Manager;
  413. on Windows NT 4.0, Control Panel is started from the Settings
  414. menu item, as on Windows 95.  The page file setting that matters
  415. most to an application on NT is the minimum page size setting.
  416. On a system with 32 MB RAM, the minimum swap space should be not 
  417. less than 20 MB, and 32 MB is better. A reasonable setting for
  418. the maximum is at least twice the minimum.
  419.  
  420. For further details about virtual memory, see the OS Help on the
  421. System dialog.
  422.  
  423.  
  424. V. Contacting Symantec for Technical Support
  425. ================================================================
  426.  
  427. During the first 90 days of your purchase, you may call Technical 
  428. support free of charge at (541) 465-8470.
  429.  
  430. 1.  Free and unlimited electronic support is available at 
  431.      http://www.symantec.com/techsupp/news/index.html, 
  432.     
  433.      Support is also available on the usenet newsgroup  
  434.      comp.lang.java
  435.  
  436.      Send bug reports to bugs@symantec.com
  437.  
  438. 2. If your User ID and Password become inoperative, please send 
  439.     e-mail notification to Customer Service at custserv@symantec.com 
  440.     with your name, address, daytime phone number, ID and password. 
  441.     Please type "Visual Cafe PRO" in the subject field. Expect a 
  442.     24-48 hour turnaround.
  443.   
  444. 3. If you have lost your Cafe ID set, please send notification to 
  445.     Customer Service at custserv@symantec.com.  In the event that 
  446.     your information does not appear in our registration database, 
  447.     we will provide additional avenues for verification of ownership.
  448.  
  449. 4. For CD purchases or damaged disks please call Customer Service 
  450.     at 800-441-7234.   
  451.             
  452.  
  453. VI. Additional Information
  454. ================================================================
  455.  
  456. Sybase SQL Anywhere 5.5
  457. -----------------------
  458. 1. Use of the Sybase SQL Anywhere Server and the Sybase SQL Anywhere 
  459. Runtime Distributable Components requires the user to read the license 
  460. information displayed in the Visual Cafe PRO installation screen and 
  461. contained in the license files provided on disk (Sybase Runtime 
  462. License and Sybase SQL Server License).
  463.  
  464. 2. Only one copy of the SQL Anywhere Server may be used for development 
  465. purposes and one copy of the SQL Anywhere Runtime Distributable 
  466. Components may be used with Visual Cafe Pro.  The Sybase Anywhere 
  467. Server and the Sybase Anywhere Runtime Distributable Components may 
  468. only be used in conjunction with dbANYWHERE Workgroup Server.
  469.  
  470. 3. End user developers may not include dbANYWHERE Workgroup Server, 
  471. Sybase SQL Anywhere Server or Sybase SQL Anywhere Runtime Distributable 
  472. Components with their applications unless each copy of their application
  473. includes a fully licensed version of Visual Cafe Pro.
  474.  
  475. 4. Sybase SQL Anywhere Server will be used for database application 
  476. development. Any deployment of the database and application will require 
  477. the use of the Sybase SQL Anywhere Runtime Distributable Components.  
  478. The Sybase SQL Anywhere Server is not licensed for use in deployment 
  479. situations.
  480.  
  481. 5. Note that the included Sybase SQL Anywhere Runtime Distributable 
  482. Components allow up to no more than 10 simultaneous connections.
  483.  
  484. 6. Because this Software is a Symantec database development product, 
  485. you have a right to host one version of the database components of 
  486. the Software product on a different physical machine than the machine 
  487. on which the development environment is used. Even though different 
  488. components of the included Software Product may be hosted on separate 
  489. physical machines, only one copy of each component may exist at one 
  490. time.  This applies to both development and runtime database engines 
  491. provided with this Software product.
  492.  
  493.  
  494. Bundler Utility
  495. ---------------
  496. Due to a large number of requests late in the beta cycle of Visual 
  497. Cafe PRO, we have included an early version of our Bundler utility 
  498. that will allow you to easily figure out which class files are used 
  499. by your applet (or application), and need to be uploaded to your 
  500. web server. Once your Java app is ready, execute the following 
  501. command at the command prompt (please make sure that 
  502. \visualcafe\bin is in your path):
  503.  
  504. Bundler.exe -make -cdb mainclass.cdb -depend listname.dep 
  505. mainclass.java
  506.  
  507. - where mainclass is the name of the main class Java file in your 
  508.   project
  509.  
  510. - in this example, listname.dep is the file name where the list of 
  511.  classes used by your app will be generated.  Please note that 
  512.  Bundler will also list the name of the zip file (if any) where the 
  513.  class file was found.  This will allow you to know what class files 
  514.  you would need to unzip from each class zip file used by your app.  
  515.  Please note that in this version, the file listname.dep has to have 
  516.  a .dep extension.  Please note also that while the java.* class files
  517.  are logged in this file, you are not actually required to copy those 
  518.  to your web server, as they are usually available with most Internet 
  519.  browsers.
  520.  
  521. Please also note that Bundler takes the same other command line 
  522. options as the sj command line compiler,  so you can add additional 
  523. class paths, etc... if desired.
  524.  
  525.             *
  526.  
  527. JDK 1.1 Support:
  528. -----------------------------------------------------------------
  529. We are planning to aggressively support JDK 1.1 as soon as available.  
  530. Register on http://cafe.symantec.com and subscribe to the mailing 
  531. list so you are notified on our support as we make progress with new 
  532. and better versions of Visual Cafe PRO.
  533.  
  534.